home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
bbsutil
/
iscalln1.zip
/
ISCALLN.DOC
< prev
next >
Wrap
Text File
|
1994-03-05
|
7KB
|
161 lines
IsCallN
A Public Domain Utility for DOOR.SYS-Supporting Bulletin Board Systems
(Source Code available on the UniNova Support BBS: [509] 925-3893)
DISCLAIMER:
-----------
This software is public domain; the original publisher (UniNova Services
Corporation) hereby refuses liability for your use, misuse, or inability
to use the program in any manner. By using the software, you agree to
accept full liability and responsibility for any effects of the software
on your system.
COPYRIGHT:
----------
There is no copyright associated with this program -- it is truly in the
public domain and you may do with it as you please. If you distribute it
without modifications, you are -requested- to include this document with
the program. There is no legal requirement for this, however, as the
nature of property in the public domain excludes such requirements.
PURPOSE:
--------
By using this program, you can determine whether or not the caller currently
in the door, for which the DOOR.SYS file was created, is logged on to the
BBS for the nth time. As an example, using Wildcat! 3.90, you could use
this program to perform certain processing from the LOGIN1.BAT file on a
caller's first call -- or 100th call. Perhaps a welcoming message, or a
"Thank you for being so loyal" message, could be sent on a specific call,
using a product such as PostMaster to import the message.
The program is general enough to allow you some creativity with it. If you
feel you have found a new and unusual use for it, UniNova is curious to hear
how people will use it. You may log on to the UniNova Support BBS at the
number shown above, or send a FAX to the same number, to tell your story.
You can also send a letter or postcard to the address appearing at the end
of this document. Obviously, there is no requirement for this; however, if
you do relate a story, it should be done with the understanding that your
tale may be retold in the UniNote (UniNova's quarterly newsletter) unless
you specify otherwise.
INSTALLATION:
-------------
Simply place a copy of ISCALLN.EXE in the directory of your choice; a general
utility directory, your BBS "home" directory, or any other location -- just
remember where you put it.
USAGE:
------
From within the door batch file of your choice, simply add a call to the
program, and check the DOS ERRORLEVEL after the program exits. (If the
idea of checking errorlevels is unfamiliar to you, you may wish to review
the topic in your DOS manual. However, the examples here may suffice.)
The syntax is:
ISCALLN # d:\path\door.sys
# : This is a number indicating the call you want to take action on.
If, for example, you want to send a "Thank you" message to every
caller on their 100th call, you would use 100 for this parameter.
d:\path\door.sys : This is the complete path (including drive if
need be) and filename for DOOR.SYS. If the program can't open
the file as you specify it here, it'll let you know.
The error levels returned by the program are:
0 : This is NOT the caller's nth call
1 : This IS the caller's nth call
5 : Error: Insufficient parameters
6 : Error: Couldn't open DOOR.SYS
7 : Error: End of DOOR.SYS reached unexpectedly
Please see the batch files below for examples. Always remember to check
the highest errorlevel first and work your way down, as DOS sees the
expression IF ERRORLEVEL X as "true" for values of X and higher.
The program will also display a terse message indicating whether or not a
match was made or if it exited with an error condition.
SAMPLE BATCH FILES:
-------------------
The first batch file mails a "Welcome" message to each caller on his/her
first call, using the PostMaster program. Directories are just examples
and can be used as shown or altered according to how you have your files
arranged. The second batch file lets you know that a caller has reached
the 500 call mark by adding a note to your activity log. Both examples
are for Wildcat! systems; this is not to imply that IsCallN is limited to
Wildcat! SysOps of other systems are bound to find parallel or other uses.
@echo off
rem This is the first example batch file
iscalln 1 c:\wc30\wcwork\node1\door.sys
if errorlevel 5 goto oops
if errorlevel 1 goto first
goto end
:first
postmstr /I:WELCOME.TXT /T:DOOR /F:SYSOP /S:Welcome! /P /C:0 /A:RULES.TXT
goto end
:oops
echo Error encountered in ISCALLN program!! >> c:\wc30\activity.001
:end
@echo off
rem This is the second example batch file
iscalln 500 d:\bbs\wcwork\node1\door.sys
if errorlevel 5 goto error
if errorlevel 1 goto mark
goto end
:mark
echo ### This user is calling for the 500th time! >> d:\bbs\activity.001
goto end
:error
echo Error encountered in ISCALLN program! >> d:\bbs\activity.001
:end
OTHER COMMENTS:
---------------
This program was written by UniNova Services Corporation for its own use,
and released to the public domain to allow other SysOps to take advantage
of its functionality. A copyright and registration fee were briefly
considered, but abandoned. SysOps have enough costs without charging for
tiny utilities such as this. The source code for IsCallN is available for
download from the UniNova Support BBS.
You are encouraged to contact UniNova if you are in the market for computer
products! Hardware, software, accessories... UniNova also offers a variety
of other services via the UniNova Support BBS, such as "green FAX services",
FriendFind(tm), etc. (Please note the BBS phone number at the beginning of
this document.)
If you would like to add your BBS to the .QWK echo network TUNNIL, which
UniNova operates as part of its support function, please log on to the
support BBS and download the file TUNNIL.LZH, which contains information
about the network. In addition, UniNova offers documentation services for
shareware authors who would rather not write their own program documentation,
or simply want a professional proofreading prior to distributing their
product.
If you'd like to write to UniNova rather than sending a FAX or connecting to
the BBS, you may reach the company at:
UniNova Services Corp.
PO Box 900
Ellensburg, WA 98926
ACKS:
-----
All product names and trademarks mentioned in this document are the property
of their respective owners; their appearance here is not intended as an
infringement on ownership rights.
Anyone who distributes this program and documentation together, unmodified,
is also hereby acknowledged and thanked -- we'll admit it, parts of it are
unabashed advertising!
IF YOU PRINT THIS DOCUMENT, PLEASE RECYCLE IT WHEN YOU ARE FINISHED WITH IT.